Modifying the default ICFWS session
To run your Progress Dynamics application as a Web application, the Progress Dynamics WebSpeed Broker/Agent must be able to access your application database and your application Repository. One method for enabling Broker/Agent access is to modify the default ICFWS session to include your application’s database and Repository as session services. For an alternative method, see the "Creating a new ICFWS session" section.
This section describes how to modify the default ICFWS session, using the tutorial databases (described in OpenEdge Development: Progress Dynamics Getting Started ) as examples.
The tutorial in OpenEdge Development: Progress Dynamics Getting Started
uses DynSports, the Progress Dynamics sample database, as an application database. It is created in a work directory for the tutorial (<wrk>\Tutorial\databases\dynsports\dynsports.db).
A Repository for the application is created in <wrk>\Tutorial\databases\icfdb\icfdb.db.
In the tutorial, both databases are started in a script and run under servers in a network environment. For example:
Also note that icfdb and dynsports have been defined as services with port numbers in the Windows services file.
Adding a database to ICFWS as a session service
The general procedure for adding a database as a service in a session type is to define it as a logical service and as a physical service, and then add it to the session. You use the session tools found in the Administration tool to perform these tasks.
This section uses the DynSports database (created in the tutorial in OpenEdge Development: Progress Dynamics Getting Started ) as an example of an application database. You can also use the procedure described in this section to add a Repository database to the ICFWS session.
|
To add a database as a session service: |
- Start a Progress Dynamics session that has administrative privileges.
- From the Progress Dynamics AppBuilder Tools menu, select Administration.
- Choose Session
Logical Service Control from the Administration tool. The Logical Service Control dialog box appears, as shown: - Choose Add Record from the File menu, or click
on the toolbar at the bottom of the window, to add a new service. The Logical Service Maintenance dialog box appears. - Set the values for the new service.
- Save the completed Logical Service Maintenance dialog box, as shown:
- Exit from the maintenance and control dialog boxes.
- Choose Session Physical Service Control from the Administration tool. The Physical Service Control dialog box appears, as shown:
- Choose Add Record from the File menu, or click on the toolbar at the bottom of the window, to add a new physical service. The Physical Service Maintenance dialog box appears.
- Type the values for the new service. Assuming you start DynSports in multi-user mode, the following are typical values:
- Save the completed Details tab, as shown:
- Select the Service tab in the Physical Service Maintenance dialog box and choose Add record ( on the toolbar).
- Enter the following values:
- Save the completed Service tab, as shown:
- Exit from the maintenance and control dialog boxes.
- Verify that the service has been added to the ICFWS session type.
For the tutorial application, use the shortcut that you used to start a development session for the tutorial.
The following table shows typical values for DynSports:
dynports session service in the tutorial, you can use it instead of creating a new service called dynsportstut. However, if you have multiple instances of a sample database like DynSports or the ICFDB Repository database, it is useful to adopt a naming convention that identifies which database you are using. In this case, the name dynsportstut implies that the service uses the DynSports database that was created in the tutorial work directory.
The Service (-S) value, dynsports, implies that dynsports has been defined with a port number in the Windows services file and that you start the database with a command similar to:
This adds the DynSports application database that you used in the tutorial as a service in the ICFWS session. It also creates the association between the logical and physical service code names.
You can verify the settings in the ICWS session type by following the procedure described in the "Viewing the default ICFWS session settings" section.
Basically, you run the Session Type Maintenance tool and check the Session Services node under ICFWS. After you complete the tasks described in this section, the Session Services list should include an entry for dynsportstut, as shown:
To add a new Repository database, you would perform the same procedure described in this section. However, you would also remove the default Repository session service, which is described in the "Removing a session service from ICFWS" section.
Removing a session service from ICFWS
The installation of Progress Dynamics creates an ICFWS session with a network connection to the default Repository (ICFDBn). If you create a separate Repository for your application (as you do in the OpenEdge Development: Progress Dynamics Getting Started
tutorial), you should add the application Repository as a session service and remove the default Repository as a session service.
Follow the procedure described in the "Adding a database to ICFWS as a session service" section to add the application Repository to ICFWS. Then perform the following procedure.
|
|
To remove the default Repository service: |
- Start a Progress Dynamics session that has administrative privileges.
- From the Progress Dynamics AppBuilder Tools menu, select Administration.
- From the Administration Session menu, select Session Type Control.
- In the Session type code lookup field at the top left of the window, enter DynDBBound and click Find to expand the session type tree.
- Expand the DynDBBound node, and expand the Session Services node below it.
- Select the session service that you want to remove. The following shows the ICFDBn service selected:
- Choose Delete Record from the File menu, or click
on the Session Service Maintenance toolbar in the right frame.
For the tutorial application, use the shortcut that you used to start a development session for the tutorial.
A confirmation window appears. Click OK confirm the deletion.
Note: This procedure does not completely remove ICFDBn. It removes it from ICFWS and any other session types that inherit from DynDBBound as a session service, but ICFWS remains available to add to other session types.